home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Tools / cpx / CLIPBORD / READ_ME.1ST < prev    next >
Encoding:
Text File  |  1998-03-14  |  10.0 KB  |  220 lines
  1. ===========================================================================
  2.                          Atari Clipboard CPX
  3.                              Version 1.0
  4.                 (c) 1991 Software Development Systems
  5.                          Released as Freeware
  6.                        Written by Scott Sanders
  7. ===========================================================================
  8.  
  9. IN THIS ARCHIVE
  10. ---------------
  11.  
  12. CLIPBORD.CPX - Place this in your CPX folder (Note the name change from
  13.                V0.9)
  14.  READ_ME.1ST - This document.
  15.   SCRAP2.TXT - ASCII reprint of the Atari Clipboard Standard.
  16.  NICPR20.TXT - Press Release of the Newdesk Icon Editor CPX Version 2.0
  17.  CPXICON.RSC - Resource file with icons to merge when using the Newdesk
  18.                Icon Editor CPX from SDS
  19.  
  20. USERS UPGRADING FROM 0.9
  21. ------------------------
  22.  
  23. You can skip on to the section labeled 'OPERATION' since this is the major
  24. portion of this documentation that has changed.
  25.  
  26. INTRODUCTION
  27. ------------
  28.  
  29. Ever since the first Atari computers rolled off the assembly line TOS was
  30. capable of information sharing between applications.  An example of this
  31. would be to say, highlight a block of text in your word processor, select
  32. cut from the menu bar, quit the word processor, load a desktop publisher,
  33. select paste into a text box and lo and behold your text would appear.  The
  34. sad truth is, however, that very few applications handle this well, if at
  35. all.
  36.  
  37. To support the old saying, 'Better late than never', Atari recently firmly
  38. defined the protocal (method) for using the Atari clipboard.  Great, right?
  39. Well, the problem is that most applications out there on the market don't
  40. utilize the new standard correctly.  Basically, this means two things. 
  41. First, hopefully, developers will see the benefits of inter-process
  42. communication and support the standard in new products and upgrades. 
  43. Software Development Systems is including full clipboard support in our
  44. Newdesk Icon Editor and Printer Utilities Pak packages.  Second, some
  45. developers are going to require your nagging to make this work. I know how
  46. it is when you spend hours making something work the way you like it. If it
  47. ain't broke, why fix it, right?  Well, anyone who's seen the ease at which
  48. Macintosh computers exchange information between programs can tell you that
  49. making this standard uniform would be well worth the effort.
  50.  
  51. OK, SO WHAT DOES IT DO?
  52. -----------------------
  53.  
  54. The Atari Clipboard system is built around two system calls scrp_read() and
  55. scrp_write(). They don't actually read or write information to the
  56. clipboard, they just let you access the pathname where the clipboard is
  57. located.  Simply put, this CPX lets you better manage where your clipboard
  58. is located (what drive and path) and gives you some other options like
  59. clearing the directory on bootup and whenever else you choose. If your
  60. favorite application has written out an ASCII text file, a GEM .IMG
  61. graphic, or a .XIC extended icon file, you can also view the contents. I've
  62. also added an option which allows greater compatibility with those
  63. applications that haven't caught up to the standard yet. STalker and
  64. Aladdin, two wonderful programs, are both culprits of this.
  65.  
  66. INSTALLATION 
  67. ------------
  68.  
  69. Simply put the file CLIPBRD.CPX in your CPX directory and either reboot or
  70. reload your CPX's (consult the CPX documentation for details).  A few
  71. promotional text files accompany this file as well as a .RSC file.  The
  72. .RSC file DOES NOT have to be included in the same directory as the CPX. It
  73. is an unrelated file. It contains a icon to represent CPX's in .RSC format
  74. which can only be used by the Newdesk Icon Editor CPX. It is a benefit to
  75. those owners only.
  76.  
  77. To start simply double-click on the CPX titled Atari Clipboard and you're
  78. ready to go.
  79.  
  80. OPERATION
  81. ---------
  82.  
  83. On the screen your current clipboard directory is displayed. When first run
  84. this should say C:\CLIPBRD (or A:\CLIPBRD on a floppy system) unless
  85. another application has already changed it. To change the location of your
  86. clipboard simply click in the text box between the two arrows and a
  87. file-selector will appear. Go to the path where you want your clipboard
  88. files stored and select OK. If the pathname is longer than the space
  89. provided you can use the arrow keys to scroll through it.
  90.  
  91. Selecting Save will save your current default clipboard directory, the
  92. default directory from where you view files, and the status of the 'Clear
  93. on boot?' button.  If that button is checked your default clipboard
  94. directory will be cleared on bootup automatically.
  95.  
  96. Exiting with OK sets the default clipboard directory.  Cancel leaves it as
  97. before.
  98.  
  99. By clicking on the button labeled >>Options<< you have access to four
  100. additional functions:
  101.  
  102. Selecting 'Clear Clip' will, after verifying it with you, delete all
  103. SCRAP.* files from your clipboard directory.
  104.  
  105. 'Create Folder' will, if you confirm, create a \CLIPBRD\ directory on your
  106. boot drive.
  107.  
  108. 'Last scrp_write()' will tell you what the last application wrote as its
  109. clipboard directory. This is the item that will stay in effect unless you
  110. leave the CPX by clicking on OK or the close box. For specific notes on
  111. this, see the notes on STalker below.
  112.  
  113. 'View Clip' is the cornerstone feature of version 1.0. By choosing this
  114. option the CPX will search the directory specified on the main screen
  115. (either 'Atari Clipboard' or the root of an installed drive) for any
  116. SCRAP.* files. If SCRAP.ASC or SCRAP.TXT is found, the CPX will assume it
  117. is an ASCII (CRLF) document and display it. If it finds a SCRAP.IMG or
  118. SCRAP.XIC file it will display it. Slider bars can be used to view an image
  119. or text file that won't fit in the display area. Clicking on the question
  120. mark acts like a toggle and displays a directory of the view area (masked
  121. to SCRAP.*). To copy a scrap to a separate file, click on the file name on
  122. the view screen and you will be presented with a file selector to choose a
  123. path and filename for the copy.  Click OK to return.
  124.  
  125. VIEW LIMITATIONS
  126. ----------------
  127.  
  128. ASCII Text files are trunctuated to 200 lines. .IMG graphics are limited to
  129. 4096x4096. .XIC files must be 32x32 and only the first icon in a file will
  130. be displayed.
  131.  
  132. WHAT'S COMING IN V1.??
  133. ----------------------
  134.  
  135. Essentially I'm planning to add .GEM metafile support and maybe others. I'd
  136. love to hear suggestions. In addition, I will add full .XIC support for all
  137. icon sizes and multiple icon viewing.
  138.  
  139. DISTRIBUTION
  140. ------------
  141.  
  142. Software Development Systems grants conditional permission to distribute
  143. this file as long as no charge (except for maximum $5.00 distribution fee)
  144. is placed on its distribution, the file includes this document, and is not
  145. altered in any way.
  146.  
  147. Developers, please feel free to put this archive on your distribution disk
  148. when your product supports the clipboard. Just drop me a line and let me
  149. know, that'll be all the pat in the back I'll need.
  150.  
  151. SPECIAL NOTES FOR USE WITH STALKER AND ALADDIN
  152. ----------------------------------------------
  153.  
  154. STalker 3.00, now supported by Gribnif Software is one of the leading edge
  155. telecommunication programs available for the ST today. Its current
  156. implementation of the clipboard standard is incorrect though I've heard
  157. mention that this is being changed.  The problem is that it currently
  158. ignores what the clipboard might have been, writes a clipboard item, then
  159. sets the clipboard path to where it wants to be. This essentially ignores
  160. this CPX and will affect any applications you run afterwards before
  161. resetting your clipboard path with our CPX. After doing a Clipboard
  162. operation in STalker, enter our CPX and use the option 'Last scrp_write()'.
  163. You'll see that STalker changed the clipboard path and even wrote a
  164. filename. It should look like 'D:\SCRAP.TXT' (applications should only
  165. write a path, never a filename).  Simply click OK to rewrite the correct
  166. path or better yet, set your default clipboard path to the root of the
  167. drive you have STalker configured to write to. No more conflicts.
  168.  
  169. Aladdin works slightly different in that it writes its scrap files to the
  170. root of the drive it resides on but doesn't bother to update the current
  171. scrap path.  Again, to force Aladdin and other programs to work well
  172. together you should set your default directory to the root of the drive
  173. Aladdin exists on.
  174.  
  175. TECHNICAL NOTES
  176. ---------------
  177.  
  178. For those programmers professional and amateur out there, please consider
  179. using the Atari Clipboard standard. In a year or so, Atari users could be
  180. experiencing data exchange between applications without a second thought.
  181. As an added bonus, Atari has generously allowed me to include an ASCII copy
  182. of the article in ATARI.RSC, the official developer's newsletter which
  183. recently redefined the standard. This article, written by Mike Fulton at
  184. Atari, is now the standard by which all applications should use their
  185. clipboard. The file in this archive is entitled SCRAP2.TXT. Kudos to Bill
  186. Rehbock and Mike Fulton for their help and suggestions.
  187.  
  188. DISCLAIMER
  189. ----------
  190.  
  191. Software Development Systems place no warranty whatsoever on this product. 
  192. SDS will not be held responsible for any damages resulting from the use of
  193. this product either incidental or consequential. This includes loss of
  194. wages and data loss.
  195.  
  196. Software Development Systems is also not associated in any way with Gribnif
  197. Software or General Electric Information Services, nor the makers of
  198. Stalker and Aladdin.
  199.  
  200. BUG REPORTS & SUGGESTIONS
  201. -------------------------
  202.  
  203. If you have any suggestions you'd like to contibute to this project, or you
  204. think you've found a bug, contact me by BBS, phone, or USPS, and I'll try
  205. to look into it ASAP.
  206.  
  207.                       Software Development Systems
  208.                       996 Redondo Ave. #404
  209.                       Long Beach, CA 90804
  210.                       Orders: (800) 237-4SDS
  211.                 Tech Support: (310) 595-9799
  212.  
  213.                       GENIE: S.SANDERS2
  214.                  Compuserve: 71760,2140
  215.  
  216. Thank you for supporting Atari Computers!
  217.  
  218. -Scott Sanders
  219.  Member IAAD
  220.